Listed — Directory & Listing Template

Listed Documentation v1.0 by Surjith S M


Introduction


First of all, Thank you so much for purchasing this template and for being my loyal customer. You are awesome!
You are entitled to get free lifetime updates to this product + exceptional support from the author directly.

This documentation is to help you regarding each step of customization. Please go through the documentation carefully to understand how this template is made and how to edit this properly. Basic HTML and CSS knowledge is required to customize this template. You may learn basics from the links below.

Learn HTML basics

Buyers Guide to Customizing HTML Templates

If you are new to HTML, I highly recommend that you watch the video tutorials below which I have outlined some basic steps for customizing HTML. Its 20 minutes long. But It worth it if you are a newbie.

Please note: The demo shown in this video is based on another template, but it will definitely help you in editing any HTML template.

Requirements to Customize this Template

You will need the following sofwares to customize this template.

  1. Code Editing Software (eg: Dreamweaver, Sublime Text or Notepad++)
  2. Web Browser for testing (eg: Google Chrome or Mozilla Firefox)
  3. FTP Tool to upload files to Server (eg: FileZilla)
Be careful while editing the template. If not edited properly, the design layout may break completely.
No support is provided for faulty customization.

Getting Started #back to top

If you are able to read this documentation locally, which means you have successfully downloaded the package and extracted the zip. The file structure as follows :

    Listed/
    ├── Help Docs/   
    ├── HTML/
    │   ├── css/
    │   ├── fonts/
    │   ├── images/  
    │   ├── php/ 
    │   ├── sass/ 
    │   ├── *.html 
                 

The folder you have to customize is the HTML folder. Copy HTML folder from the package and paste it in your Project Folder. (This helps you to prevent overwriting in original files. so if you messed up something, you will get the original here.)

Pages #back to top

Here are the list of HTML Pages included with this template

  1. Home Page index.html
  2. Home Style Two index-two.html
  3. Lsiting listing.html
  4. Lsiting Detail detail.html
  5. Lsiting listing.html
  6. Add new Lsiting add-listing.html
  7. Pricing pricing.html
  8. Checkout payment-method.html
  9. Thank you thank-you.html
  10. Contact / Help contact.html
  11. 404 Error 404.html
  12. Blog List blog.html
  13. Blog Layout two blog-two.html
  14. Blog Single blog-detail.html
  15. Popup - Login / Signup All Pages

Page Settings #back to top

If you are choosing the Homepage Two layout for the Homepage, remember to rename the file name to index.html It is required to use the same name to make it work as default page (homepage) when you upload to your server.

Customization

You can now customize the HTML files by opening it in a code editing software and you can modify the text as required. See above video tutorial if you want to know how to do it.

Form Settings #back to top

Contact form #back to top

To setup contact form, Follow the steps below.

To receive emails, First you need to set your email address. Open /php/contact.php file in your code editor. Then you can change the Email ID and Subject. See sample below

Note: Contact form will work only on a PHP Live Server Environment with Mail() function Enabled Servers. It won't work locally as well as on server where Mail() function is disabled. So Please contact the server admin before opening a support ticket.
/*
 * ------------------------------------
 * Contact Form Configuration
 * ------------------------------------
 */
 
$to    = "test@surjithctly.in"; // Your email ID here 
Tip: If you did not see the message in your email inbox, a) Please check Spam / Junk Folder b) Try using another email.

Redirect on Success (Thank you page)

If you want your users to be redirected to another page after completing the form successfully such as Thank you page or Success page. It is really easy to do with this Template. Open index.html and Just add data-redirect="/path/to/thanks.html" to <form> element and you are done. See example:

<!-- // NOTE THE data-redirect attribute -->
 <form action="php/contact.php" method="POST" data-redirect="success.html">

Alternatively, If you don't want to redirect your users and want to stay in same page, Just change the data-redirect attribute value to none.

Other Settings #back to top

Google Maps #back to top

A Styled Google Map is included with this Template. To show the Map with your settings, You will need to obtain Maps API key from google. Follow the steps below

Step 1: Obtain Google Maps API Key

  1. Go to https://developers.google.com/maps/.../get-api-key
  2. Click the “Get a Key” button and create new project
  3. You will need to provide your Website URl.
    Note: You should give correct Website URL or Maps will not work.
  4. On the next step, Choose "API key for Web Browser”
  5. Then the app will generate a new API Key. Copy that.

Step 2: Add the API key to the HTML File

Open the HTML page which contains the Google Map. Now find the code below

<script src="https://maps.googleapis.com/maps/api/js?callback=myMap&key=API_KEY_HERE"></script>
  

Replace the API key in the API_KEY_HERE part with your actual API key we obtained from Step 1.

Step 3: Setup Location

In the HTML page, find the code as shown below.

                        <div id="map" class="row m0" data-lat="37.3818288" data-lon="-122.0636325" data-zoom="15"></div>
                        

In the above code part, You can change location and zoom of the Map by changing data-* attribute. Available settings are listed below.

  1. Map Location : data-lat="" : Latitude of your event location. data-lon="" : Longitude of your event location.
  2. Map Zoom: data-zoom="" : Set Zoom level of Map

Once you have changed all settings above, You're done. Refresh the page to see changes.

To find latitude and longitude of your location, Please use http://www.latlong.net/

SASS (SCSS) #back to top

SASS is a popular CSS Pre-Processor which helps writing CSS much more faster and easier.
See more info on http://sass-lang.com/

If you are writing SCSS (the writing language of SASS) you will need to compile it to regular CSS to see your changes in the browser. Typically each time when you save an SCSS file, you will need a program to complie it as regular CSS.

Fortunately, there are many Applications & command-line tools to achive that. I suggest you to check http://sass-lang.com/install for more information.

If you are just starting out, I suggest you to use a GUI Application instead of command-line. My Favorite Pick is https://prepros.io/. It works on Mac and Windows. Also It has unlimited free trial, means you can try it as long as you need with full functionality. No restrictions.

Extras #back to top

Web Hosting #back to top

Once you have finished all customizations, The next step is to upload your Landing Page to a Live Hosting Server. For that you will need to buy a Hosting Plan and a Domain name from a Service Provider.

Web Hosting Guide

Uploading to Server #back to top

Once you have registered a domain name and Hosting, You will get FTP details from your hosting provider. Use that login details to connect with your server. You will need an FTP Software for this such as FileZilla. Connect with your server and open /public_html folder in your server. Then copy all HTML, CSS and JS files from your local machine to your root /public_html folder in your server. Please note the HTML files should be in the Server's root folder. If your local project is in /your-folder/ Do not upload the folder directly. Instead open the folder and select all HTML files and CSS, JS folders and upload.

Website Optimization Tips #back to top

A Fast & Optimized Website has several factors which needs to be implemented in order to achieve the desired results. There are several Optimization Techniques available which will definitely affect your Website's Performance in a Positive Way & we want to share a few of them with you:

  1. gZip Compression & Browser Caching

    This is probably one of the Most Important Techniques you should definitely implement in order to bump up your Website's Loading Speed. gZip Compression is used to compress the Files that are delivered when loading a Website. It covers HTML, CSS, Javascript & Font Files along with other miscellaneous text files. Where as Browser Caching also covers Images & Videos apart from including the above files. This is used to saves the Static Data in your Browser itself so that when you open the Next Pages on the Same Website, the content does not gets Downloaded again, loading the Website fast.

    gZip Compression & Browser Caching can be enabled using the .htaccess File on an Apache Web Server. You can use the Codes from here: https://github.com/h5bp/html5-boilerplate/blob/master/dist/.htaccess to enable these modules on your server.

  2. Image Compression & Optimization

    We tend to use Lots of Images on our Websites but we often do not make efforts to Compress & Optimize them. Remember, the Larger the Image, the more time it takes to download and therefore this slows your website loading times affecting User Experience. Your customer will leave your website if it does not load within 3-5 Seconds which adversely affects your Sales. Therefore, it is important to Resize, Optimize & Compress your Images before using it on your Website. Here are some Tips which might come handy in optimizing images:

    1. Resize your Images: Resize your Images before using it on your Website. Do not just Download an Image & place it as it is in your Website's <img> Tag without resizing it. The size/resolution of the Image matters since it is not recommended to use an Image size of 1200px x 800px in a Content Size of 300px x 200px as this is unnecessary. Resize it to 300px x 200px
    2. Image Formats: There are three common file types that are used for web images which are JPEG, GIF, & PNG. For images with a Flat Background use JPEG images, for images with a Transparent background use PNG images and for images with Animations use GIF images.
    3. Compressing Images: Images Compression is important as it considerably reduces the size without losing the quality. There are several FREE Image Optimization Tools available to Download.
      For MAC use ImageOptim
      For Windows use Riot for compressing JPEG Images & PNG Gauntlet for PNG Images.
  3. CSS & jQuery Minifications

    It is also recommended that you Combine & Minify all your CSS Files to a single CSS File & all Javascript Files to a single JS File since Minification reduces the size of the File and Combining the files helps in reducing the number of HTTP requests made to the server. This is also an Important Factor in increasing the speed of your website. There are several tools available online to Minify your CSS & JS Files. Our recommendations are:
    For CSS use CSS Minifier and For Javascript use Javascript Minifier.

  4. Content Delivery Network

    You can use a CDN to further speed up your website. You can use the CDN to deliver static files of your website like CSS, JS, Images & Font Files. There are several CDN Hosting Providers available on the Internet but we would recommend MaxCDN or CloudFlare. Note: CDN setup requires Extra monthly Fees to setup, so it is completely optional & according to your needs. Cloudflare also has a Free plan, you can try that for free.

  5. Fast Web Hosting Servers

    A lot depends on your Web Hosting Servers, so it is recommended that you choose a Hosting Company/Server that provides a Reliable & a Fast Hosting Service. You can also choose our shared hosting plans. See above.

Check Google Page Speed Check Gtmetrix Grade

Credits #back to top

We are really thankful to the makers of the frameworks, plugins and images below. We used these to make this Landing Page more functional. Demo images, you have seen in Live Demo is not included in the download package because of their copyright restrictions.

Libraries

  1. jQuery

Images / Videos

  1. Unsplash

Others

  1. PHPMailer

Changelog #back to top

How to Upgrade #back to top

If you have purchased an earlier version and want to upgrade your website to the newwer version of this template, You can follow the steps. In each update, we will keep a changelog or version history, where we will keep the log of all changes made. We will list out the Changes made, Features added and Pages modified. So it will be easier for you to replace the existing. If you have modified a file which has latest update, for example, CSS, Open both page in a code editor and use a Comparison Sofware or an Online Tool like Diff Now to compare changes in both files. Then you can manually copy paste the changed lines without affecting your file. NOTE: We recommend that you keep a separate file for new additions or changes if possible.

Version 1.0 (01 June, 2018) #back to top

Initial Version

Rate it #back to top

If you like the template, Please consider Rating it on Themeforest by Visiting your Downloads Page : http://themeforest.net/downloads That means a lot to me :)

rate this template

Support #back to top

Please remember you have purchased a very affordable template and you have not paid for a full-time web design agency. Occasionally we will help with small tweaks, but these requests will be put on a lower priority due to their nature. Please be patient, polite and respectful. We will try to answer your questions as soon as possible

Support for my items includes:
  1. Responding to questions or problems regarding the item and its features
  2. Fixing bugs and reported issues
  3. Providing updates to ensure compatibility with new software versions
Item support does not include:
  1. Customization and installation services
  2. Support for third party software and plug-ins
Before making a support request, please do...
  1. Make sure your question is a valid issue and not a customization request.
  2. Make sure you have read through the documentation and any related guides before asking support on how to accomplish a task.
  3. Try to use "Google Search" for common questions. Most of the times, which will help faster than the support.

Contact Support

Thank you! #back to top

Once again, Thank you so much for purchasing this template and being by loyal customer. You can reach me pesonally on Twitter @surjithctly or via my Personal Email (No Support requests please.. use support website instead)


Copyright © Surjith S M. All rights reserved.